home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 4 / Amiga Tools 4.iso / tools / dfue / term / documentation / xpr_libs / xprzvoice.doc < prev   
Encoding:
Text File  |  1993-03-10  |  7.4 KB  |  227 lines
  1.                      xprzvoice.library - Benutzerinfos
  2.                      ---------------------------------
  3.  
  4.  - Die Voicemodus-Unterstützung für das ZyXEL-Modem und jedes
  5.    XPR-fähige Terminalprogramm
  6.  
  7. 0) Rechtliche Grundlagen
  8. ------------------------
  9.  
  10. Das Programm ist PD, was heißt, jeder kann es weiterverbreiten wie er will.
  11. Ebenso kann das Programm auch über PD-Serien verteilt werden (ich bitte
  12. darum :-).
  13.  
  14. Ausgenommen folgendes:
  15.  
  16.  o Das Archiv muß in seiner ursprünglichen Form erhalten bleiben, es darf
  17.    nicht weiterverbreitet werden, wenn Files verändert, hinzugefügt oder
  18.    weggelassen werden.
  19.    Displayme-Files, wie sie diverse Boxen in ihren Archiven reinpacken,
  20.    fallen auch unter dieser Beschränkung.
  21.  
  22.  o Der Vertreiber darf keine Kosten verlangen, die über NACHVOLLZIEHBARE
  23.    Datenträgerkosten (und bei Postversand auch Porto...) hinausgehen.
  24.    Da eine Diskette knapp eine Mark kostet, ist es Wucher, für eine
  25.    volle PD-Diskette 4.- DM zu verlangen.
  26.  
  27.  o Kein Programm in diesem Paket darf verändert und weiterverteilt werden -
  28.    Anderenfalls würde jeder "seine" Version herausbringen und keiner
  29.    würde mehr durchblicken... Schaut euch nur mal die diversen
  30.    SoundTracker-Clones und das Durcheinander mit der xprzmodem.library
  31.    an...
  32.    Falls Fehler in diesem Programm sind, dann kann derjenige mir einen
  33.    Hinweis geben.
  34.  
  35.  
  36. 1) Inhalt
  37. ---------
  38.  
  39. Zum Vergleich mal den Archivinhalt, wie es sein müßte.
  40.  
  41.  xprzvoice.doc          - Dieses Info.
  42.  xprzvoice.library      - Die Library, um die es geht.
  43.  MadLaugh.ZVOC          - Ein Beispiel-File, das man abspielen kann.
  44.  
  45.  
  46. Falls irgendetwas zuviel ist oder fehlt, dann bitte beim SysOp oder
  47. Vertreiber beschweren.
  48.  
  49.  
  50. 2) Installation
  51. ---------------
  52.  
  53. Einfach die xprzvoice.library ins LIBS:-Verzeichnis kopieren.
  54. Danach das Terminalprogramm starten und die Library als XPR-Library
  55. aussuchen.
  56. Wie das im einzelnen von sich geht, muß jeder selbst herausfinden, da das
  57. von Programm zu Programm unterschiedlich ist.
  58.  
  59.  
  60. 2.1) Erster Testlauf
  61. --------------------
  62.  
  63. Wenn das Terminalprogramm sich dann nicht beschwert hat, (Library nicht
  64. gefunden, konnte nicht öffnen ect...) dann folgendes:
  65.  
  66.  1. Übertragungsgeschwindigkeit auf 38400 oder höher stellen
  67.  
  68.  2. "AT+FCLASS=8" <RETURN> tippen
  69.  
  70.  3. Nach dem OK "AT+VSM=2" <RETURN> tippen
  71.  
  72.  4. Nach diesem OK "AT+VLS=16" <RETURN> tippen
  73.  
  74. * Mit dem ersten Befehl wurde das ZyXEL-Modem in den Voicemodus geschaltet,
  75.   mit dem zweiten die ADPCM-2-Kompression gewählt und mit dem dritten
  76.   der interne Lautsprecher zur Ausgabe aufgeschaltet.
  77.  
  78.  5. Wähle aus dem Transfermenü "Upload" und mit dem (sicherlich
  79.     erscheinenden) Filerequester das File "MadLaugh.ZVOC" aus.
  80.  
  81. * Läuft die Übertragung, dann wird in 5000er-Schritten gezählt, und nach
  82.   einer kurzen Zeit wird ein Sample im Modem abgespielt.
  83.   Ist der Computer fertig, so wird das Statusfenster vom Upload
  84.   verschwinden und man kann sofort wieder Befehle zum Modem schicken.
  85.  
  86.  6. "AT+VLS=0Z" <RETURN> tippen
  87.  
  88. * Damit wird das Modem wieder zurückgestellt.
  89.  
  90. Falls irgendetwas schiefgelaufen ist, bitte unter "Fehlermeldungen"
  91. nachschlagen....
  92.  
  93.  
  94. 3) Funktionen
  95. -------------
  96.  
  97. Ganz einfach: Upload spielt ein Sample ab, während Download ein Sample
  98. aufnimmt.
  99. Das, was die Library als Initstring erwartet (bei ZModem lautet dieser
  100. "K0,Q0,R1,PRAM:" oder so, nur zur Verdeutlichung was ich meine) ist die
  101. Anzahl der Bytes, die maximal aufgenommen werden, also die zeitliche
  102. Begrenzung des Samples.
  103.  
  104. Dabei übernimmt diese Library vom Start (der Anweisung, in welche Richtung
  105. die Daten fließen) bis zum Ende (der Abschlußkennung <DLE><ETX>) den
  106. gesamten Datentransfer auf sich, ebenso die XON/XOFF-Erkennung, sodaß man
  107. sich darum nicht mehr sorgen braucht.
  108.  
  109. Alles, was außerhalb der xpr-Library noch geschehen muß, ist das Modem für
  110. Sprache zu initialisieren (eben der Befehl AT+FCLASS=8), den Kompressions-
  111. algorithmus (CELP, ADPCM2, ADPCM3) und den Tonkanal (Lautsprecher, Mikrofon
  112. oder Telefonleitung) auszusuchen und die Übertragung (Up- oder Download) zu
  113. starten. Ein Beispiel ist ja schon genannt worden...
  114.  
  115.  
  116. 4) Fehlermeldungen
  117. ------------------
  118.  
  119. Neben den üblichen "Sending File", "Receiving File", "Aborting...",
  120. "Aborted" und "Done" gibt es noch diese, die allerdings nur beim Abspielen
  121. (Upload) von Sprachdaten auftreten:
  122.  
  123.  "Modem went mad"
  124.  
  125.   Das heißt, das die Bytes, die an das Modem geschickt wurden, wieder
  126.   zurückgeschickt wurden und nicht als Sprachdaten erkannt wurden.
  127.   Das liegt entweder daran, daß ein falsches File abgespielt wurde oder
  128.   kein Ausgabekanal offen war.
  129.   Gegebenenfalls muß man einige Male "at" <RETURN> tippen, ehe sich das
  130.   Modem wieder beruhigt, und statt irgendwelcher Schrottzeichen wieder
  131.   ein "OK" sendet.
  132.  
  133.  "XOFF without XON"
  134.  
  135.   Normalerweise kommt es nicht vor... Es bedeutet, daß das Modem die
  136.   Übertragung (mittels XOFF) gestoppt, aber nicht innerhalb einer
  137.   Zeitspanne wieder freigegeben hat.
  138.  
  139.  "Aborted"
  140.  
  141.   Falls das beim Upload auftaucht ohne daß man selbst abgebrochen hat,
  142.   heißt das, das ein Besetztzeichen (die Gegenstelle hat aufgelegt)
  143.   oder ein Faxrufton erkannt wurde und es nicht sinnvoll ist, weiter
  144.   sprachdaten abzuspielen.
  145.  
  146. 5) Bugs?
  147. --------
  148.  
  149. Hmmm... Jetzt kommt das Unangenehme... :-/
  150.  
  151. Fehler, die zum Absturz des Systems oder des Programms führten, sind mir
  152. nicht bekannt.
  153.  
  154. Folgendes allerdings:
  155.  
  156. Ein aufgenommenes Sample vom ZyXEL hat keine Endekennung, da der Empfang
  157. nach der voreingestellten Anzahl Bytes automatisch stoppt und der Rest, der
  158. vom Modem kommt, ignoriert wird.
  159. Soweit nicht schlimm, denn beim Senden wird die Endekennung automatisch
  160. angehängt, sodaß man sofort wieder im Befehlsmodus landet.
  161.  
  162. ---
  163.  
  164. Will man mehrere Operationen hintereinander machen (wie Sample abspielen
  165. und aufnehmen), dann muß man dazwischen denselben Ausgabekanal noch einmal
  166. aufschalten (also den AT+VLS=x - Befehl mit denselben x nocheinmal senden).
  167.  
  168. ---
  169.  
  170. NComm hat hin und wieder Probleme bekommen, wenn es seine Balkengrafik
  171. anzeigen soll - da wurde der untere Bildschirmbereich verhunzt, aber alles
  172. lief ohne Schwierigkeiten weiter. Vermute mal, es kommt mit den fehlenden
  173. Übertragungszeiten nicht zurecht..
  174.  
  175. ---
  176.  
  177. Zumindest bei NComm muß die Anzahl maximal zu empfangender Bytes direkt mit
  178. dem Initstring angegeben werden, da bei der Abfrage ("Enter maximum receive
  179. Bytes") der Wert ignoriert wird.
  180. In meiner Library konnte ich keinen Fehler ausmachen....
  181.  
  182. ---
  183.  
  184. Nehme ich Files in ADPCM-3-Kompression und spiele sie wieder ab, dann kommt
  185. nur ein häßliches Rauschen und Quietschen aus den Lautsprecher.
  186.  
  187.  
  188. 6) Zukünftiges
  189. --------------
  190.  
  191.  o Erstmal Bugs beseitigen (sofern sie bei mir liegen) oder (falls nicht
  192.    allzu aufwendig) Workarounds kreieren.
  193.  
  194.  o Rückgabe des Abbruchgrunds beim Abspielen der Sounddaten
  195.    (Per environment-Variable geht m.W. nicht, da die eine Datei ist
  196.    und ich die dos.library aus der xpr-Lib nicht benutzen darf...)
  197.    Vielleicht Speicherung in einem unbenutzten S-Register?
  198.    Vorschläge her....
  199.  
  200.  o Warte auf Vorschläge...
  201.  
  202.  
  203. 7) Vergangenes
  204. --------------
  205.  
  206.  10-03-93  Version 1.00 - Erste offiziell verbreitete Version
  207.  
  208.  
  209. 8) Disclaimer
  210. -------------
  211.  
  212. Obwohl ich mich bemüht habe, sämtliche schweren Fehler auszumerzen und
  213. systemkonform zu programmieren, kann ich nicht dafür garantieren, daß das
  214. Programm auf Deinen Rechner sauber läuft.
  215.  
  216. Sämtliche Risiken in Bezug auf Datensicherheit und Hardware liegen beim
  217. Benutzer.
  218.  
  219.  
  220. 9) Kontaktadresse
  221. -----------------
  222.  
  223. Briefe, Flames, Fehlerberichte (huh?) und Ähnliches bitte dorthin:
  224.  
  225.         Fido:  Carsten Pluntke @ 2:2401/306.5
  226.  
  227.